The "Apple 3DMF Viewer" is a OpenDoc-based QuickDraw™ 3D viewer. It allows you to embed QuickDraw™ 3D (3DMF) objects in OpenDoc documents.
Requirements
• OpenDoc™
• QuickDraw 1.0.3 or later. (QuickDraw 3D 1.0.6 is available from the world wide web at http://quickdraw3d.apple.com/QD3DDownload.HTML.)
• A PowerPC-based Macintosh compatable computer with a minimum of 16 megabytes of memory (RAM).
Using the Apple 3DMF Viewer
To use the Apple 3DMF Viewer simply embed 3DMF data in an OpenDoc document (or a container application that supports OpenDoc). This can be done by dragging 3DMF files from the finder into the document, or by copying and pasting the data into the document.
The Apple 3DMF Viewer is similar to other QuickDraw 3D viewers such as SimpleText or the Scrapbook. The primary difference lies in the way the Apple 3DMF Viewer does not display controls in the same window as the 3D object. To view the controls click on the 3D badge (3D icon) in the lower left hand of the viewer's frame or use the "Show 3D Controller" menu item in the "3D" menu while the viewer is active.
There are several controls which affect how mouse clicks on a 3D object affect the camera position (view) of the object. Which control is currently selected can be changed using menu items in the "3D" menu or buttons in the control window. There are keyboard equivalents to all the control menu items.
If the camera position is manipulated it modifies the document and is saved if the document is saved. The camera position will be restored when the document is reopened.
If the badge is not visible this could mean that QuickDraw 3D is not available or there is not enough memory to use the 3D Viewer. If the viewer frame is made active a message will be displayed that describes why the 3D viewer could not be used. If a static image of the 3D object is available, it will be displayed.
To copy or drag and drop 3DMF data from the viewer it first must be selected. To select the data activate the viewer and use the "Select All" menu command in the "Edit" menu.
Developer Notes
These notes are for developers only.
The 3DMF Viewer stores the 3DMF data in the value "+//ISO 9070/ANSI::113722::US::CI LABS::MacOS:ScrapType:3DMF". This string can be obtained by calling GetISOTypeFromPlatformType(ev, '3DMF', kODPlatformFileType) on the ODTranslation object. The data in the value is standard 3DMF data.
The 3DMF Viewer also stores a static PICT in the value "+//ISO 9070/ANSI::113722::US::CI LABS::MacOS:ScrapType:PICT". As above this string can be obtained by calling GetISOTypeFromPlatformType(ev, 'PICT', kODPlatformFileType) on the ODTranslation object.
The 3DMF Viewer also stores an optional annotation that describes the last used camera position. This annotation is stored in the annotation kODPropPreAnnotation"CameraSettings" and value kODTypePrefix"Apple:QD3DCameraPosition". The data written out is a TQ3CameraPlacement structure followed by TQ3CameraRange structure.
Bug Reporting
Report any problems you find by using the bug report form on this CD to odbugs@apple.com or use the bug report form at http://www.opendoc.apple.com/forms/bug_report.html. In either case be sure to report the specific version of the viewer. The version can be obtained by selecting the part library and using the "Get Info" command in the finder.
